QuickTime 4 API Documentation

3D Graphics Programming with QuickDraw 3D 1.5.4

Previous | QD3D Book | Overview | Chapter Contents | Next |

Managing Fill Styles

QuickDraw 3D provides routines that you can use to manage fill styles.

Q3FillStyle_New

You can use the Q3FillStyle_New function to create a new fill style object.

TQ3StyleObject Q3FillStyle_New (TQ3FillStyle fillStyle);
fillStyle
A fill style value.

DESCRIPTION

The Q3FillStyle_New function returns, as its function result, a new style object having the fill style specified by the fillStyle parameter. The fillStyle parameter should be one of these values:

kQ3FillStyleFilled
kQ3FillStyleEdges
kQ3FillStylePoints

If a new style object could not be created, Q3FillStyle_New returns the value NULL .

To change the current fill style, you must actually draw the style object. You can call Q3Style_Submit to draw the style in retained mode or Q3FillStyle_Submit (described next) to draw the style in immediate mode.

SEE ALSO

See "Fill Styles" for a description of the available fill styles.

Q3FillStyle_Submit

You can use the Q3FillStyle_Submit function to submit a fill style in immediate mode.

TQ3Status Q3FillStyle_Submit (
                     TQ3FillStyle fillStyle,
                     TQ3ViewObject view);
fillStyle
A fill style value.
view
A view.

DESCRIPTION

The Q3FillStyle_Submit function sets the fill style of the view specified by the view parameter to the style specified in the fillStyle parameter.

SPECIAL CONSIDERATIONS

You should call Q3FillStyle_Submit only in a submitting loop.

Q3FillStyle_Get

You can use the Q3FillStyle_Get function to get the fill style value of a fill style.

TQ3Status Q3FillStyle_Get (
                     TQ3StyleObject styleObject,
                     TQ3FillStyle *fillStyle);
styleObject
A fill style object.
fillStyle
On exit, a pointer to the fill style value of the specified fill style object.

DESCRIPTION

The Q3FillStyle_Get function returns, in the fillStyle parameter, a pointer to the current fill style value of the fill style object specified by the styleObject parameter.

Q3FillStyle_Set

You can use the Q3FillStyle_Set function to set the fill style value of a fill style.

TQ3Status Q3FillStyle_Set (
                     TQ3StyleObject styleObject,
                     TQ3FillStyle fillStyle);
styleObject
A fill style object.
fillStyle
A fill style value.

DESCRIPTION

The Q3FillStyle_Set function sets the fill style value of the style object specified by the styleObject parameter to the value specified in the fillStyle parameter.

© 1997 Apple Computer, Inc.

Previous | QD3D Book | Overview | Chapter Contents | Next |